////////////////////////////////////////////////////////////////////////////////
// Copyright 2010 Michael Schmalle - Teoti Graphix, LLC
// 
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
// 
// http://www.apache.org/licenses/LICENSE-2.0 
// 
// Unless required by applicable law or agreed to in writing, software 
// distributed under the License is distributed on an "AS IS" BASIS, 
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and 
// limitations under the License
// 
// Author: Michael Schmalle, Principal Architect
// mschmalle at teotigraphix dot com
////////////////////////////////////////////////////////////////////////////////

package fxplugins.core
{

/**
 * The default injector used to add API references to an instance.
 * 
 * <p>This is a simple injector that adds the <code>componentMap</code>
 * reference to the instance.</p>
 * 
 * <p>In more complicated implementations it could use metadata parsed
 * by some 3rd party framework to inject references into the instance.</p>
 * 
 * @author Michael Schmalle
 * @copyright Teoti Graphix, LLC
 * @productversion 1.0
 */
public class Injector implements IComponentInjector, IComponentMapAware
{
	//--------------------------------------------------------------------------
	//
	//  IComponentMapAware API :: Properties
	//
	//--------------------------------------------------------------------------
	
	//----------------------------------
	//  componentMap
	//----------------------------------
	
	/**
	 * @private
	 */
	private var _componentMap:IComponentMap;
	
	/**
	 * @copy fxplugins.core.IComponentMapAware#componentMap
	 */
	public function get componentMap():IComponentMap
	{
		return _componentMap;
	}
	
	/**
	 * @private
	 */	
	public function set componentMap(value:IComponentMap):void
	{
		if (_componentMap == value)
			return;
		
		_componentMap = value;
	}
	
	//--------------------------------------------------------------------------
	//
	//  Constructor
	//
	//--------------------------------------------------------------------------
	
	/**
	 * Constructor.
	 */
	public function Injector()
	{
		super();
	}
	
	//--------------------------------------------------------------------------
	//
	//  IInjector API :: Methods
	//
	//--------------------------------------------------------------------------
	
	/**
	 * @private
	 */
	public function injectInto(instance:Object):void
	{
		if (instance is IComponentMapAware)
			IComponentMapAware(instance).componentMap = _componentMap;		
	}
}
}